home *** CD-ROM | disk | FTP | other *** search
/ IRIX Patches 1995 September / SGI IRIX Patches 1995 Sep.iso / 5.3_patches / patchSG0000567 / patchSG0000567.idb / var / inst / help1.z / help1
Text File  |  1995-09-07  |  87KB  |  1,983 lines
  1.  
  2. @  admin
  3.                                      admin
  4.  
  5.     "admin" is a command on the Inst Main Menu and a short name for the
  6.     Administrative Commands Menu.
  7.  
  8.     Give the "admin" command when you want to switch to the Administrative
  9.     Commands Menu.
  10.  
  11.     Alternatively, if you want to execute a command from the Administrative
  12.     Commands Menu while you are in the Inst Main Menu, you can give the
  13.     command "admin <command>".  It executes <command> as if your current menu
  14.     were the Administrative Commands Menu, but leaves you in the Inst Main
  15.     Menu.
  16.  
  17.     The Administrative Commands Menu provides a variety of functions that are
  18.     not needed for most installations.  See "help <command>" for each of the
  19.     commands on the Administrative Commands Menu to learn more about them.
  20.  
  21.     The following commands are available from the Administrative Commands
  22.     Menu, but are not listed: "quit" and "help".
  23.  
  24. @  recalculate
  25.                                   recalculate
  26.  
  27.     "recalculate" is a command on the Administrative Commands Menu.
  28.  
  29.     The "recalculate" command causes inst to do a disk space calculation.
  30.     This means that it identifies the current amount of free disk space and
  31.     calculates the impact of installing the selected subsystems.
  32.  
  33.     This command is needed only when you remove files during an installation
  34.     without using "go", i.e. you escape to a shell and use the rm command.  In
  35.     this case, inst needs to recalculate its idea of the free disk space in
  36.     order to give you accurate disk space usage information.
  37.  
  38. @  config
  39.                                      config
  40.     "config" is a command on the Administrative Commands Menu.
  41.  
  42.     The "config" command causes inst to display the list of installed
  43.     configuration files on the system. Configuration files are very likely to
  44.     need modification because they contain information that is often machine-
  45.     specific or site-specific.  Config files with an "m" in the first column
  46.     of output are config files which size or checksum is different from the
  47.     version orginally installed.  "config changed" outputs any config files
  48.     with the same name that have a .O or .N appended. The .O version of the
  49.     configuration file is your earlier version.  The no-suffix version
  50.     contains changes that are required for compatibility with the rest of the
  51.     newly installed software, that increase functionality, or that fix bugs.
  52.     You should use diff(1) or gdiff(1) to compare the two versions of the
  53.     files and transfer information that you recognize as machine or site-
  54.     specific from the .O version to the no-suffix version.  The .N version of
  55.     the configuration file is the new version.  It contains changes or new
  56.     features that can be added to the no-suffix version of the configuration
  57.     file at your option.  You should use diff(1) or gdiff(1) to compare the
  58.     two versions of the files and add changes that appeared in the new
  59.     software from the .N version to the no-suffix version if you want them.
  60.  
  61. @  load
  62.                                       load
  63.     "load" is a command on the Administrative Commands Menu.
  64.  
  65.     The "load" command is used to open a file that contains a custom selection
  66.     of software. Such files were previously created using the "save" command.
  67.  
  68.  
  69. @  save
  70.                                       save
  71.     "save" is a command on the Administrative Commands Menu.
  72.  
  73.     The "save" command saves the current custom selections of software in a
  74.     file that you can later open by choosing "load".
  75.  
  76. @  hardware
  77.                                     hardware
  78.     "hardware" is a command on the Administrative Commands Menu.
  79.  
  80.     The "hardware" command outputs internal hardware variables.
  81.  
  82. @  files
  83.                                      files
  84.  
  85.     "files" is a command on the Administrative Commands Menu.
  86.  
  87.     The "files" command may be used to list the names of the files that make
  88.     up subsystems that are available for installation.  Other file information
  89.     displayed includes pending requests for the file (i.e.  install, remove,
  90.     or keep), the installation state, the subsystem name, disk space delta,
  91.     and type.
  92.  
  93.     Knowing the files that make up a subsystem can be helpful in determining
  94.     what specific functions are provided by the subsystem, and may help in the
  95.     subsystem selection process.
  96.  
  97.     *** Change from old inst ***
  98.  
  99.     The new inst allows viewing files from the distribution or the target.  If
  100.     the subsystem is on both the target and distribution, the default now is
  101.     to show files on the target and distribution. To see only files on the
  102.     distribution use the command "files D <sybsystem>" which will only view
  103.     files on the distribution.
  104.  
  105. @  from
  106.                                       from
  107.  
  108.     "from" is a command on the Inst Main Menu.
  109.  
  110.     Use the "from" command to specify the location (or "source") of the
  111.     software distribution you wish to install.  The source may be a local
  112.     tape, a local or remote CD-ROM drive, or a local or remote distribution
  113.     directory.
  114.  
  115.     When inst first comes up, it prints a message about the default location
  116.     of the software distribution.  If this location is correct, then there is
  117.     no need to give the "from" command immediately.
  118.  
  119.     You can check to see what the current distribution source is after product
  120.     descriptions have been read by giving the "set" command.  The value of the
  121.     "set" preference called "dist" is the current distribution location.
  122.  
  123.     Giving a "from" command causes these things to happen:
  124.  
  125.     o   A connection with the distribution source is established.
  126.  
  127.     o   The product descriptions are read from the source.  inst displays the
  128.         list of product descriptions it reads.
  129.  
  130.     o   The current list of selections for installation and removal is
  131.         forgotten.
  132.  
  133.     You can use the "from" command four ways to specify the software
  134.     distribution source you want to use:
  135.  
  136.     from            Use prompting mode
  137.  
  138.     from <source>   Specify the distribution source explicitly
  139.  
  140.     from $dist      Specify that you want to reuse the current distribution
  141.                     source
  142.  
  143.     from none       Don't use any distribution.  Useful for removals only.
  144.  
  145.     When using "from" in prompt mode, a list of former installation sites is
  146.     displayed. Enter the number of the distribution to use. The "set"
  147.     preference "install_sites_size" controls the number of install sites in
  148.     the list.
  149.  
  150.     When using <source> or $dist and a non-tape distribution source, you can
  151.     append "/<product>" if you want to install just a single product.  When
  152.     just a single product is read from a distribution directory or CD-ROM,
  153.     disk space checking is done just for that product and is substantially
  154.     faster.
  155.  
  156.     The syntax of <source> depends on the distribution source and the user ID
  157.     you want to use:
  158.  
  159.     <path>                   Local tape, CD-ROM, or distribution directory
  160.  
  161.     <server>:<path>          Remote CD-ROM, or distribution directory with
  162.                              user ID "guest"
  163.  
  164.     <user>@<server>:<path>   Remote CD-ROM, or distribution directory with
  165.                              user ID <user>
  166.  
  167.     <server> is the name of the remote workstation and <user> is a user ID
  168.     that has been configured for installation (see the IRIS Software
  169.     Installation Guide).  The possible values for <path> are:
  170.  
  171.     /CDROM/dist      For a local CD-ROM
  172.  
  173.     <CDdir>/dist     For a remote CD-ROM mounted at <CDdir>
  174.  
  175.     <distdir>        For a local or remote distribution directory in the
  176.                      directory <distdir>
  177.  
  178.     <nrtapedevice>   For a local, no-rewind, byte-swapped, fixed block size
  179.                      tape device whose device name is <nrtapedevice>, e.g.
  180.                      /dev/rmt/tps0d2nrs.
  181.  
  182.     Some examples of the "from" command are:
  183.  
  184.     from none                     Read no distribution, and set the view to
  185.                                   target
  186.  
  187.     from server:/CDROM/dist       Read from a CD mounted at /CDROM on a remote
  188.                                   workstation
  189.  
  190.     from joe@server:/d/distdir    Read all product descriptors from a remote
  191.                                   distribution directory as user "joe"
  192.  
  193.     from server:/d/distdir/nfs    Read a single product "nfs" from a remote
  194.                                   distribution directory
  195.  
  196.     from $dist                    Reuse last distribution source
  197.  
  198.     from $dist/nfs                Reuse last distribution source, but read
  199.                                   only the "nfs" product from it
  200.  
  201.     from /dev/rmt/tps0d2nrs       Read from a local tape drive on SCSI
  202.                                   controller 0, unit 2.
  203.  
  204.     *** Change from old inst ***
  205.  
  206.     The shorthand distribution "tape" (e.g. "from tape") for referring to the
  207.     local tape drive is no longer supported.  Please specify the device
  208.     explicitly by controller and unit number.
  209.  
  210.     Tape drive types other than QIC and DAT have not been tested.
  211.  
  212.     Remote tape is not supported.
  213.  
  214.     If you get an error message about not being able to read the product
  215.     description, there may be a problem in accessing the distribution or the
  216.     copy of the distribution itself may be bad.  See "help networkerror" and
  217.     "help readerror" for more information.
  218.  
  219. @  networkerror
  220.                                   networkerror
  221.  
  222.     This "help" topic provides information about problems with network access.
  223.  
  224.     Network access errors can occur for the following reasons:
  225.  
  226.     o   NIS or BIND hosts databases do not have correct IP address information
  227.         for your workstation or the remote workstation, the proper IP address
  228.         is not in non-volatile RAM (NVRAM) on your workstation, and/or the
  229.         proper IP addresses are not set in the local or remote /etc/hosts
  230.         files.
  231.  
  232.     o   There may be a problem in the network configuration.
  233.  
  234.     o   The network connection may be blocked or unavailable.
  235.  
  236.     o   There might have been a failure during opening a file or reading a
  237.         directory.
  238.  
  239.     o   There may be a problem on the remote workstation.
  240.  
  241.     Information about diagnosing network access problems and setting up a
  242.     remote account for installation is available in the IRIS Software
  243.     Installation Guide.
  244.  
  245.     Information about network configuration is available in the IRIX Network
  246.     Administration Guide.
  247.  
  248. @  space
  249.                                      space
  250.  
  251.     "space" is a command on the Administrative Commands Menu.
  252.  
  253.     The "space" command gives disk space summary information.  If the "set"
  254.     preference "delayspacecheck" is "off", it is the same as the "list" and
  255.     "step" commands.  If "delayspacecheck" is "on", then giving the "space"
  256.     command forces the disk space calculation to be performed and a disk space
  257.     summary appears.
  258.  
  259. @  spaceerror
  260.                                    spaceerror
  261.  
  262.     This "help" topic provides information about disk space problems.
  263.  
  264.     As the available software grows and the number of user files increases,
  265.     disk space becomes more and more limited.  If you cannot install because
  266.     of disk space problems, you must do one or more of the following:
  267.  
  268.     1.  Reduce the demand for disk space by installing fewer and/or smaller
  269.         subsystems.
  270.  
  271.         You can accomplish this by using commands on the Inst Main Menu to
  272.         change the installation requests on a per-subsystem basis, until the
  273.         required space is sufficiently reduced.  See "install", "keep",
  274.         "remove", and "step" for more information on how to do this.
  275.  
  276.     2.  Increase the available disk space by removing unnecessary user files
  277.         from the disk.
  278.  
  279.         You can use the "versions" command to assist in this process.  The
  280.         "versions user" command lists the names of files that are not part of
  281.         the software installed on the system.  Some of these files may be
  282.         files that you don't need; they can be deleted by using the "sh"
  283.         command to escape to a shell and using the IRIX rm command to remove
  284.         them.
  285.  
  286.         When using miniroot installation, your filesystems are mounted as
  287.         "/root" and "/root/usr", which means the pathnames must have "/root"
  288.         prepended.  For example, if your home directory is "/usr/people/fred",
  289.         it is mounted as "/root/usr/people/fred" while running in the
  290.         miniroot.  You can use the "shroot" command instead of "sh" to invoke
  291.         a shell that enables you to use the normal pathnames.
  292.  
  293.         Overall free space on the disk is typically updated when you return
  294.         from shell so a "recalculate" command is unnecessary when removing
  295.         user files.
  296.  
  297.         Note that if you use "rm" to remove files from installed subsystems,
  298.         you should use the "recalculate" command after returning to inst to
  299.         request that disk space be recalculated to reflect the changes.
  300.  
  301.     3.  Remove unnecessary subsystems from the disk.
  302.  
  303.         The product distributions usually consist of software (*.sw.*), online
  304.         man pages (*.man.*), and InSight viewable documentation (*.books.*).
  305.         If you are short on space you may find that certain software, man
  306.         pages, or documentation groupings are not needed.  Use the "showprods"
  307.         command without arguments to list all subsystems installed on the
  308.         disk.  Use the "remove" command followed by the "go" command to remove
  309.         unnecessary subsystems.
  310.  
  311.     Keep in mind that only one filesystem may be involved.  It is possible
  312.     that the overflow is only on the "root" filesystem, in which case removing
  313.     files from the "/usr" filesystem won't help.
  314.  
  315.     The disk space totals already account for removal of old versions of
  316.     software that are being replaced, obsoleted, or overwritten by the new
  317.     software.  Removing subsystems explicitly prior to installing new versions
  318.     does not help with disk space problems.
  319.  
  320. @  go
  321.                                        go
  322.  
  323.     "go" is a command on the Inst Main Menu.
  324.  
  325.     Once the "install", "remove", and "keep" requests are complete, the
  326.     installations and removals are initiated when you give the "go" command.
  327.     Before the actual installations and removals are done, pre-installation
  328.     checks are done to make sure that the selections are valid.  If any of
  329.     these checks fail, the installation and/or removal operations aren't done.
  330.     See "help check" for a list of these pre-installation checks.
  331.  
  332. @  conflicts
  333.                                    conflicts
  334.  
  335.     "conflicts" is a command on the Inst Main Menu.
  336.  
  337.     It is used to view, or resolve, the current installation conflicts.
  338.  
  339.     conflicts             If no arguments are given, the current conflicts are
  340.                           displayed.  Each conflict is identified by a number.
  341.                           Along with each conflict a set of choices is given
  342.                           which will resolve that conflict.  Each choice is
  343.                           identified by a number/letter pair (1a, 2c, etc.)
  344.  
  345.     conflicts choice ..   If choices are given, inst resolves the conflicts by
  346.                           applying the specified choices.
  347.  
  348.     The easiest way to resolve conflicts is to issue the "conflicts" command
  349.     once to see the conflict list, then issue the command again, along with
  350.     your choices.  Alternatively, you may continue using the "install",
  351.     "remove" or "keep" commands to modify the current installation request.
  352.  
  353.     All installation conflicts (missing prerequisites, missing required
  354.     subsystems, incompatible subsystems, etc.) must be resolved before giving
  355.     the "go" command.
  356.  
  357.     In the example below, a subsystem (insight.sw.client) is selected for
  358.     removal, but other subsystems list it as a prerequisite.  In order to
  359.     resolve the conflict, either insight.sw.client must not removed, or the
  360.     other products must also be removed:
  361.  
  362.         Inst> remove insight.sw.client
  363.  
  364.         Inst> conflicts
  365.  
  366.         insight.sw.client (IRIS InSight Viewer, 2.3) cannot be removed because
  367.         other products depend on them:
  368.           1a. Do not remove insight.sw.client (IRIS InSight Viewer, 2.3)
  369.           1b. Also remove
  370.               dev.books.IRIX_NetPG (IRIX Network Programming Guide)
  371.               dev.books.IRIX_SysPG (IRIX System Programming Guide)
  372.               WorkShop.books.WRKSHP_UG (WorkShop User's Guide)
  373.  
  374.         Resolve conflicts by typing "conflicts choice choice ..."
  375.         Or try help conflicts
  376.  
  377.         Inst> conflicts 1b
  378.         No conflicts
  379.  
  380. @  install
  381.                                     install
  382.  
  383.     "install" is a command on the Inst Main Menu and a keyword argument for
  384.     the "install", "keep", "list", "remove", and "step" commands.
  385.  
  386.     The "install" command is used to identify or select subsystems that should
  387.     be installed.  Note that this is a request only; the installation does not
  388.     occur until you use the "go" command.  Until then, you may alter your
  389.     selections as you wish, using the "install", "keep", and "remove"
  390.     commands, or "step" mode.  See also "help selection".
  391.  
  392.     You can see the subsystems available for installation with the "list"
  393.     command.  Subsystems selected for installation have an "i" in the first
  394.     column.
  395.  
  396.     inst makes an initial guess at the subsystems you are likely to want
  397.     installed which takes into account whether your workstation has "seen" the
  398.     product before.
  399.  
  400.     *** Change from old inst ***
  401.  
  402.     The new inst initial selections are based on the preference
  403.     "install_selection".  The default value of this preference is "upgrade".
  404.     Only subsystems on the distribution which have an older version installed
  405.     are selected by default for installation.
  406.  
  407.     The keyword "install" (or just "i") is a shorthand for all of the
  408.     subsystems that are selected for installation (i.e. have a "i" at the
  409.     beginning of the line in a "list" or "step" display).
  410.  
  411. @  keep
  412.                                       keep
  413.  
  414.     "keep" is a command on the Inst Main Menu and a keyword argument for the
  415.     "install", "keep", "list", "remove", and "step" commands.
  416.  
  417.     The "keep" command of the Inst Main Menu is used to identify or select
  418.     subsystems that should be kept as-is on the disk.  It cancels any install
  419.     or remove requests you have made for the specified subsystems, so that the
  420.     existing version on the disk, if any, remains undisturbed.  See also "help
  421.     selection".
  422.  
  423.     *** Change from old inst ***
  424.  
  425.     Because of the new "view" command. "k" is only displayed on subsystem on
  426.     the target.
  427.  
  428.     The keyword "keep" (or just "k") is a shorthand for all of the subsystems
  429.     that are marked for no change (i.e. have a "k" at the beginning of the
  430.     line in a "list" or "step" display).
  431.  
  432. @  list
  433.                                       list
  434.  
  435.     "list" is a command on the Inst Main Menu.
  436.  
  437.     The "list" command shows the subsystems that make up the currently
  438.     available distribution or the subsystems that are currently installed on
  439.     the target. Each subsystem represents a collection of files that can be
  440.     installed or removed as a unit.
  441.  
  442.     Any of the single letter column values explained below can be used as
  443.     keyword modifiers to the list command. See "help keywords" for more
  444.     information.
  445.  
  446.     Included in the listing are several columns of information about each
  447.     subsystem.  The first column is one of the following characters, which
  448.     indicate the current request for the subsystem:
  449.  
  450.     i         Install this subsystem after removing the old version, if any
  451.  
  452.     r         Remove the old version subsystem
  453.  
  454.     k         Keep this subsystem as-is on the disk
  455.  
  456.     (blank)   Do not install this subsystem
  457.  
  458.     The second column indicates the current status of the subsystem.
  459.  
  460.     The possible value for subsystems on the distribution are:
  461.  
  462.     S         This version already installed
  463.  
  464.     U         An older version of some related subsystem is installed
  465.  
  466.     O         A newer version of some related subsystem is installed
  467.  
  468.     N         A new subsytem with no related version installed
  469.  
  470.     The possible value for subsystems on the target are:
  471.  
  472.     I         Subsytem is currently installed
  473.  
  474.     R         Subsystem was installed but removed
  475.  
  476.     blank     Subsytem was never installed
  477.  
  478.     The next column shows the name of the product, image, or subsystem.  These
  479.     names are used as arguments to "list", "install", "keep", "remove",
  480.     "step", and "versions".  Following some of the names in "[]" are single
  481.     character codes:
  482.  
  483.     d   means that the subsystem has been designated a default subsystem
  484.  
  485.     b   means that the subsystem must be installed from the miniroot
  486.  
  487.     r   means that the subsystem has been designated a required subsystem
  488.  
  489.     The last column gives a brief description of the subsystem.
  490.  
  491.     *** Change from old inst ***
  492.  
  493.     The size numbers are no longer space deltas. They represent the total size
  494.     of the subsystem.
  495.  
  496.     The deltas about the installation and removal request and the overhead are
  497.     no longer displayed.  The summary at the bottom of the list provides
  498.     information on how the sum of the installation and removal requests will
  499.     affect the amount of disk space on each filesystem:
  500.  
  501.  
  502.     Net change in blocks           The total of the previous three values,
  503.                                    i.e.  the total projected disk space change
  504.                                    for the requested operations
  505.  
  506.     Blocks available               The free space available on the filesystem
  507.  
  508.     If "Net change in blocks" is larger than "Blocks available", the
  509.     installation cannot proceed because of the extreme likelihood of running
  510.     out of disk space.  The problem is detected when you issue the "go"
  511.     command.  Get help on "spaceerror" if you run into such disk space
  512.     problems.
  513.  
  514. @  selection request
  515.                                 selection request
  516.  
  517.     "selection" and "request" are important terms in the installation process.
  518.     You make "selections" and "requests" with the "install", "keep", "remove",
  519.     and "step" commands, that is you tell inst that you want it to install,
  520.     not install/not remove (keep), or remove subsystems.  Since these commands
  521.     do not take effect immediately, there is a concept of your current
  522.     selections or requests.  Your current selections can always be viewed with
  523.     the "list" command.  It shows the current selection status of each
  524.     subsystem in the first column of its output.
  525.  
  526.     You can change the current letter (request) to a different letter
  527.     (request) using the "install", "remove" and "keep" commands, or by typing
  528.     a letter in "step" mode as shown below:
  529.  
  530.         Current     Desired                     Step
  531.         Request     Request     Command         Key
  532.  
  533.         i           i                           <Enter> or n or i
  534.         i           r           remove          r
  535.         i           k           keep            k
  536.         i           blank       keep            k
  537.  
  538.         r           i           install         i
  539.         r           r                           <Enter> or n or r
  540.         r           k           keep            k
  541.         r           blank       keep            k
  542.  
  543.         k           i           install         i
  544.         k           r           remove          r
  545.         k           k                           <Enter> or n or k
  546.         k           blank       (k and blank have the same effect)
  547.  
  548.         blank       i           install         i
  549.         blank       r           remove          r
  550.         blank       k           (blank and k have the same effect)
  551.         blank       blank                       <Enter> or n or k
  552.  
  553. @  mkfs
  554.                                       mkfs
  555.  
  556.     "mkfs" is a command on the Administrative Commands Menu.  It can be used
  557.     during miniroot installations only.
  558.  
  559.     If a brand new disk is being used, or if the current contents of the disk
  560.     or a filesystem on the disk are to be completely discarded, you can make
  561.     new filesystems with this command.
  562.  
  563.     By default, with no arguments, new filesystems are made on the root "/"
  564.     and user "/usr" filesystems.  Alternately, you can specify the disk device
  565.     to operate on by name.  When specifying the disk device explicitly, use
  566.     the same block device name as appears in the output of the "admin mount"
  567.     command for the desired device.
  568.  
  569.     If there are filesystems mounted below the filesystem to be mkfs'd, then
  570.     these other filesystems are automatically unmounted before the mkfs is
  571.     done, and remounted afterward.
  572.  
  573.     The "mount" command on the Administrative Commands Menu shows what the
  574.     device names for the root and user filesystems are.
  575.  
  576.     Note that all existing files, including all directories, programs, and
  577.     data, are lost when a new filesystem is made.  Proceed with caution.  You
  578.     are warned if there is already a filesystem on the named device, and
  579.     prompted for a confirmation before any new filesystem is made.
  580.  
  581. @  mount
  582.                                      mount
  583.  
  584.     "mount" is a command on the Administrative Commands Menu.
  585.  
  586.     To find out what is mounted, to change the default mountings, or to add
  587.     new mountings that are unknown to inst, use the "mount" command.  Without
  588.     arguments, it displays what is currently mounted.  The two arguments are
  589.     the block device name and the mount point.  You can specify the mount
  590.     point in absolute terms, although it is mounted relative to /root for the
  591.     duration of the installation.
  592.  
  593. @  quit
  594.                                       quit
  595.  
  596.     "quit" is a command on the Inst Main Menu.  It is also available from the
  597.     Administrative Commands Menu.
  598.  
  599.     Use "quit" to exit from the inst program.
  600.  
  601.     If you have made installation and/or removal requests, but have not
  602.     performed the requests with the "go" command, you are asked to confirm
  603.     whether or not you really want to quit.  If you type "yes", the requests
  604.     are discarded.  If you type "no", you are returned to your current menu.
  605.     You can use the "list" command on the Inst Main Menu to find out what the
  606.     requests are, if you wish, and/or the "go" command to perform them.
  607.  
  608.     If you are using the miniroot, you are asked if you are ready to restart.
  609.     If you answer "no", you return to the Inst Main Menu.  If you answer
  610.     "yes", your system is rebooted and comes up running the new software. You
  611.     can answer "sh" to shell escape and "h" to receive help about the restart
  612.     options.
  613.  
  614. @  remove
  615.                                      remove
  616.  
  617.     "remove" is a command on the Inst Main Menu, a keyword for the "install",
  618.     "keep", "list", and "step" commands.
  619.  
  620.     Use the "remove" command to request that installed subsystems be removed
  621.     from the system.  The removal does not occur until you enter the "go"
  622.     command.  Until then, you may change the requested operations for any or
  623.     all subsystems.  To undo a "remove" request, use the "keep" command.  An
  624.     alternative to the "remove" command is the "step" command.  It enables you
  625.     to decide interactively, subsystem by subsystem, which subsystems you want
  626.     to remove.  See also "help selection".
  627.  
  628.     inst automatically removes old versions of subsystems you have selected
  629.     for installation so it is not necessary to explicitly remove them.
  630.     Typically, you remove software when you no longer need it, or when your
  631.     disk is so full that you must remove something in order to install
  632.     something you need more.
  633.  
  634.     The keyword "remove" (or just "r") is a shorthand for all of the
  635.     subsystems that are selected for removal (i.e. have a "r" at the beginning
  636.     of the line in a "list" or "step" display).
  637.  
  638. @  removed R
  639.                                     removed R
  640.  
  641.     "removed" is a keyword argument for the "install", "keep", "list", and
  642.     "step" commands.  For example, "list R" shows all subsystems that were
  643.     once installed on the target and later removed.
  644.  
  645.     An "R" (removed) single letter code in the third column of "list" or
  646.     "step" output indicates that a this is a subsystem was once installed on
  647.     the target, and later removed.
  648.  
  649. @  set
  650.                                       set
  651.  
  652.     "set" is a command on the Administrative Commands.  It is also available
  653.     from the Inst Main Menu.
  654.  
  655.     The "set" command is used to examine and change the settings of
  656.     preferences.  If you provide no arguments, the current settings are
  657.     displayed.  If you provide just the name of a preference, information
  658.     about the preference is displayed. If you provide the name and the new
  659.     value, the preference setting is changed.  The "set" command is available
  660.     from the Inst Main Menu as well, even though it isn't listed.
  661.  
  662.     *** Changes from old inst ***
  663.  
  664.     Just providing the name of a preference no longer sets the preference to
  665.     its default value.
  666.  
  667.     Some preference settings are saved in the installation history database
  668.     when you set the new value of the resource. The name of the file has
  669.     changed from ".options" to ".swmgrrc"
  670.  
  671.     Help on a specific preference is no longer available by asking for "help"
  672.     on that preference.  Use the command "set <preference>" for help on a
  673.     preference "<preference>".
  674.  
  675. @  sethostname
  676.                                   sethostname
  677.  
  678.     "sethostname" is a command on the Administrative Commands Menu.
  679.  
  680.     Used in the miniroot only to prompt the user for the network hostname of
  681.     the local workstation.  Automatically restarts the networking using the
  682.     provided hostname.
  683. @  sethostipaddr
  684.                                  sethostipaddr
  685.  
  686.     "sethostipaddr" is a command on the Administrative Commands Menu.
  687.  
  688.     Used in the miniroot only to prompt the user for the network ip address of
  689.     the local workstation.  Automatically restarts the networking using the
  690.     provided ipaddr.
  691. @  sh
  692.                                        sh
  693.  
  694.     "sh" is a command on the Administrative Commands Menu.  It is also
  695.     available from the Inst Main Menu.
  696.  
  697.     The "sh" command invokes an IRIX shell, from which you have full access to
  698.     IRIX and the filesystems.  If you provide arguments, they are taken as a
  699.     single IRIX command to be executed immediately.
  700.  
  701.     When using the miniroot, remember that your filesystems have been mounted
  702.     relative to "/root", which means that they (temporarily) have different
  703.     pathnames; e.g. what is normally known as "/usr/people/guest" is mounted
  704.     as "/root/usr/people/guest".  The "shroot" command is an alternative to
  705.     "sh" that enables you to use the familiar pathnames while you are working
  706.     in the shell.  Also remember that a very limited set of IRIX commands is
  707.     available if you are using miniroot installation.
  708.  
  709.     The program that is invoked is determined by the setting of the "shell"
  710.     option; if the value of that option is not a valid program, the command
  711.     fails.  The default is based on the SHELL environment variable, and is
  712.     normally either "/bin/sh" or "/bin/csh".
  713.  
  714. @  shroot
  715.                                      shroot
  716.  
  717.     "shroot" is a command on the Administrative Commands Menu.  It is also
  718.     available from the Inst Main Menu.
  719.  
  720.     The "shroot" command invokes a "chrooted" IRIX shell, from which you have
  721.     full access to IRIX and the filesystems.  If you provide arguments, they
  722.     are taken as a single IRIX command to be executed immediately.
  723.  
  724.     When using the miniroot, the filesystems are mounted relative to "/root",
  725.     so that "/usr/people/guest", for example, is mounted as
  726.     "/root/usr/people/guest".  To reduce the confusion under such
  727.     circumstances, the "shroot" command uses the "chroot" system call to
  728.     invoke the shell as if "/root" were its root directory, i.e. "/root"
  729.     becomes "/" for all references.  Thus files can be referred to with their
  730.     normal pathnames.
  731.  
  732.     It is not possible to use "shroot" if certain key files are not present
  733.     under the installation root.  The missing files are listed, and the shell
  734.     that is invoked is not chrooted; i.e. files must be referred to as
  735.     "/root/...".
  736.  
  737.     The program that is invoked is determined by the setting of the "shell"
  738.     option; if the value of that option does not identify a valid program, the
  739.     command fails.  The default is based on the SHELL environment variable,
  740.     and is normally either "/bin/sh" or "/bin/csh".  The specified program
  741.     must exist in the filesystem under the installation root, not the current
  742.     root.
  743.  
  744. @  step
  745.                                       step
  746.  
  747.     "step" is a command on the Inst Main Menu.  In step mode, inst displays
  748.     each product (or image or subsystem, depending on your view), then waits
  749.     for you to press a single character command to mark that product for
  750.     installation, removal or no action (keep).
  751.  
  752.     Your current view (see "help view") controls which products are displayed
  753.     by step.  Optional arguments to the step command further control what
  754.     products are displayed, as described at the end of this help article.
  755.  
  756.     Available step mode commands are:
  757.  
  758.     i                 Mark this product for installation
  759.  
  760.     r                 Mark this product for removal
  761.  
  762.     k                 Keep; cancel any install or remove request
  763.  
  764.     n, +, <Enter>     Step to the next product
  765.  
  766.     p, -              Step back to the previous product
  767.  
  768.     arrow keys        up, down, left and right; same as p, n, k, i
  769.  
  770.     u                 Upgrade; install corresponding product from distribution
  771.  
  772.     d                 Default; mark for installation only if default product
  773.  
  774.     I,R,K,N,P,U,D     Automatically apply corresponding lower case command to
  775.                       remaining subsystems in this product
  776.  
  777.     /pat              Find a product matching the given pattern
  778.  
  779.     f                 List the files in this product
  780.  
  781.     l                 Redisplay all previous products
  782.  
  783.     q                 Quit step mode
  784.  
  785.     The "step" command takes keyword arguments (see "help keywords") and
  786.     product, image, and subsystem name arguments.
  787.  
  788.     Some example uses of such arguments are:
  789.  
  790.     step installable   Use step mode on all subsystems that can be installed
  791.                        (this is the default)
  792.  
  793.     step upgrade       Use step mode on all subsystems marked `U'
  794.  
  795.     step eoe2          Use step mode on all eoe2.*.* subsystems
  796.  
  797. @  umount unmount
  798.                                  umount unmount
  799.  
  800.     "umount" is a command on the Administrative Commands Menu.
  801.  
  802.     The "umount" command of the Administrative Commands Menu is used to
  803.     unmount disks that inst has mounted by default, or that have been mounted
  804.     with the "mount" command.  The filesystem's name remains in inst's device
  805.     table even after the filesystem is unmounted.
  806.  
  807.     Note that in some cases, filesystems mounted under the specified file
  808.     system have to be unmounted first.
  809.  
  810. @  incompatible
  811.                                   incompatible
  812.  
  813.     Subsystems are designated incompatible when the system will not operate
  814.     correctly with the new version of one subsystem and an older version of
  815.     one or more other subsystems that are already installed.
  816.  
  817.     *** Change from old inst ***
  818.  
  819.     You will receive conflict messages when you issue the "go" command.  These
  820.     imcompatible conflicts must be resolved before a "go" command can be
  821.     executed.
  822.  
  823.     Incompatible subsystems or products may not be installed, unless the
  824.     conflicting subsystem is removed first.  Some subsystems are designated
  825.     incompatible because they are older versions that prevent the system from
  826.     operating.  These are usually designated as incompatible with the
  827.     eoe1.sw.unix subsystem.  In general, you must obtain an appropriate
  828.     version of the subsystem if you wish to continue using it.
  829.  
  830.     Additionally, entire products may be marked as compatible with only some
  831.     hardware configurations.  This is normally true only with hardware
  832.     specific releases.  Attempting to select any subsystem in such products
  833.     will result in a message that the subsystem was not selected because it is
  834.     not compatible with the machine.  If you receive this message, please
  835.     consult your release notes for the supported hardware configurations.
  836.  
  837.     Subsystem incompatibilities can be overridden using the
  838.     "override_conflices" option.  Use this option with extreme care since
  839.     installing incompatible software can lead to erroneous system behavior.
  840.  
  841.     See "help conflicts" for more on resolving imcompatible conflicts.
  842.  
  843. @  i
  844.                                        i
  845.  
  846.     An "i" (install) single letter code is used in the following ways:
  847.  
  848.     o   When it appears in the first column of "list" and "step" output, it
  849.         indicates that the subsystem is currently selected for installation.
  850.  
  851.     o   In "step" mode, the "i" key is used to request installation for the
  852.         currently displayed subsystem.
  853.  
  854.     o   An "i" (or "install") can be used as an argument to the "list",
  855.         "step", "keep", and "remove" commands as a shorthand for the
  856.         subsystems currently selected for installation.  For example, "list i"
  857.         lists subsystems currently selected for installation.
  858.  
  859. @  k
  860.                                        k
  861.  
  862.     A "k" (keep) single letter code is used in the following ways:
  863.  
  864.     o   When "k" appears in the first column of "list" and "step" output, it
  865.         indicates that there is a related version of the subsystem on the
  866.         disk, but no installation or removal of that subsystem will occur when
  867.         you give the "go" command.
  868.  
  869.     o   In "step" mode, the "k" key is used to request no change for the
  870.         currently displayed subsystem.
  871.  
  872.     o   A "k" (or "keep") can be used as an argument to the "list", "step",
  873.         "install", and "remove" commands as a shorthand for the subsystems
  874.         currently selected as "keep".  For example, "remove k" changes the
  875.         request for each subsystem marked "k" to "r".
  876.  
  877. @  r
  878.                                        r
  879.  
  880.     A "r" (remove) single letter code is used in the following ways:
  881.  
  882.     o   When an "r" is in the first column of "list" and "step" output, it
  883.         indicates that the subsystem is currently selected for removal.
  884.  
  885.     o   In "step" mode, the "r" key is used to request removal for the
  886.         currently displayed subsystem.
  887.  
  888.     o   An "r" (or "remove") can be used as an argument to the "list", "step",
  889.         "install", and "keep" commands as a shorthand for subsystems currently
  890.         selected for removal.  For example, "keep remove" changes the request
  891.         for each subsystem selected for removal to keep ("k").
  892.  
  893.     o   An "r" is displayed next to the names of subsystems that are required
  894.         for proper system operation.
  895.  
  896. @  *
  897.                                        *
  898.  
  899.     A "*" is used as a wildcard in product, image, and subsystems names.  See
  900.     "help wildcard".
  901.  
  902. @  wildcard
  903.                                     wildcard
  904.  
  905.     Several shell-type wildcards can be used in product, image, and subsystem
  906.     names:
  907.  
  908.     *           Matches zero or more characters in the product, image, or
  909.                 subsystem portion of a name
  910.  
  911.     ?           Matches a single character
  912.  
  913.     [<range>]   Matches a range of characters, for example [a-z] matches any
  914.                 of the characters a through z
  915.  
  916.     These shell-type constructs apply only to the product, image, or subsystem
  917.     portion of the name they are used in.  Thus, it applies from the previous
  918.     `.' (or beginning of the name) to the next `.' (or end of the name).
  919.  
  920. @  .N
  921.                                        .N
  922.  
  923.     ".N" (newer) is a suffix that is sometimes added to the names of
  924.     configuration files.
  925.  
  926.     A file whose name ends in ".N" is a new version of a configuration file
  927.     that you have previously modified.  The intent is to preserve your
  928.     existing configuration file, but make the new version available for your
  929.     perusal.  You may wish to combine features of the existing and new
  930.     configuration files into a single version, or use the new file as-is, or
  931.     simply remove the new file and not use any of the new features it
  932.     provides.  Once you have made the appropriate edits to the no-suffix
  933.     version of the configuration file, you can delete the ".N" version.
  934.  
  935. @  .O
  936.                                        .O
  937.  
  938.     ".O" (older) is a suffix that is sometimes added to the names of
  939.     configuration files.
  940.  
  941.     A file whose name ends in ".O" is a configuration file from an older
  942.     release that you have modified.  The new version of the file from the
  943.     release is considered important for proper system operation, and so has
  944.     been put into place.  You may wish to merge in features from your saved
  945.     ".O" version.  Once you have made the appropriate edits to the no-suffix
  946.     version of the configuration file, you can delete the ".O" version.
  947.  
  948. @  keywords
  949.                                     keywords
  950.  
  951.     "keywords" is an optional argument for the "install", "keep", "remove",
  952.     "list", and "step" commands.
  953.  
  954.     Keyword arguments are shorthand ways of naming groups of subsystems.  The
  955.     keywords are "all", "default", "install", "installable", "installed",
  956.     "keep", "newer", "older", "removable", "remove", and "uninstalled".  The
  957.     "list" command takes three additional keywords: "images", "products", and
  958.     "sizes".
  959.  
  960.     If more than one keyword is given, the meaning is the intersection of the
  961.     keywords.  This means that the set of subsystems that is operated on is
  962.     that set of subsystems that satisfies all of the criteria for all of the
  963.     keywords used.
  964.  
  965.     The following list gives each keyword, its abbreviation if it has one, and
  966.     a brief description.  For more information, see "help <keyword>" for each
  967.     of the keywords.
  968.  
  969.     all, a           All subsystems in "showprods -a" output plus all
  970.                      subsystems in the software distribution
  971.  
  972.     default, d       All subsystems in the distribution that are marked with
  973.                      "d".
  974.  
  975.     distribution     All subsytems in the distribution
  976.  
  977.     downgrade, D     All subsystems that have a version installed that is
  978.                      newer than the version in the software distribution
  979.  
  980.     install, i       All subsystems that are selected for installation
  981.  
  982.     installable, A   All subsystems in the software distribution
  983.  
  984.     installed, I     All subsystems that are installed on the target.
  985.  
  986.     keep, k          All installed subsystems that are in the software
  987.                      distribution, but not selected for installation or
  988.                      removal
  989.  
  990.     miniroot, b      All subsystems that must be installed in the miniroot or
  991.                      require a reboot to complete installation.
  992.  
  993.     new, N, n        All subsystems that don't have a version installed or
  994.                      even a version once installed and later removed.
  995.  
  996.     notinstalled     All subsystems that have a version on the target which
  997.                      was not installed. The version on the target was either
  998.                      removed or never installed.
  999.  
  1000.     patches          All patches in the distribution.
  1001.  
  1002.     patchupgrade, P   All patches in the distribution that are upgrades to
  1003.                      installed patches.
  1004.  
  1005.     removable, L     All of the installed subsystems that can be selected for
  1006.                      removal
  1007.  
  1008.     remove, r        All of the subsystems that are selected for removal
  1009.  
  1010.     removed, R       All subsystems that were once installed.
  1011.  
  1012.     required, q      All of the subsystems that are required for proper
  1013.                      operation of the workstation
  1014.  
  1015.     same, S, s       All subsystem that have an identical version installed
  1016.  
  1017.     target           All subsytems on the target
  1018.  
  1019.     uninstalled      Subsystems that meet all of these conditions: they were
  1020.                      available for installation in the past, they are not
  1021.                      currently installed, they don't have a version in the
  1022.                      distribution, and they are not maint subsystems
  1023.  
  1024.     upgrade, U       All subsystems that have a version installed that is
  1025.                      older than the version in the software distribution
  1026.  
  1027.     upgraded, u      Any subsystem on the target that is being removed as part
  1028.                      of an installation of a related (typically newer) version
  1029.                      of the product from the distribution.
  1030.  
  1031. @  filter
  1032.                                      filter
  1033.  
  1034.     The filter command on the view submenu lets you see or hide products shown
  1035.     by list and step, based on such attributes as whether they are upgrades,
  1036.     downgrades, installed, removed, ...
  1037.  
  1038.     Each filter attribute applies just to products on the distribution {dist},
  1039.     or just to products on the target {targ}.
  1040.  
  1041.     The "filter" command with just one argument turns that filter on.
  1042.  
  1043.     When a filter is on, that means that products matching that attribute are
  1044.     visible.  When a filter is off, products matching that attribute are not
  1045.     visible (unless they match some other filter that is on).
  1046.  
  1047.     filter all [on|off]          Show all products on distribution {dist}.
  1048.  
  1049.     filter new [on|off]          Show new, not installed, products {dist}.
  1050.  
  1051.     filter upgrade [on|off]      Show upgrades, newer versions of what is
  1052.                                  installed {dist}.
  1053.  
  1054.     filter same [on|off]         Show products that are already installed, at
  1055.                                  the same version {dist}.
  1056.  
  1057.     filter downgrade [on|off]    Show downgrades, older versions of what is
  1058.                                  installed {dist}.
  1059.  
  1060.     filter notinstalled [on|off]   Show any products on distribution that
  1061.                                  aren't upgrades, downgrades, new or same -
  1062.                                  typically products you chose to not install
  1063.                                  earlier {dist}.
  1064.  
  1065.     filter installed [on|off]    Show products currently installed {targ}.
  1066.  
  1067.     filter removed [on|off]      Show products installed, then removed {targ}.
  1068.  
  1069.     filter rejected [on|off]     Show products intentionally not installed in
  1070.                                  an earlier inst session {targ}.
  1071.  
  1072. @  main
  1073.                                       main
  1074.  
  1075.     The Inst Main Menu is the first menu that is displayed to an inst user.
  1076.     This menu provides all of the commands needed during a typical
  1077.     installation session.
  1078.  
  1079.     There are several other commands that are available from this menu, but
  1080.     are not listed.  They are "set", "sh", and "shroot".
  1081.  
  1082. @  product image subsystem
  1083.                              product image subsystem
  1084.  
  1085.     This "help" topic give the definitions of product, image, and subsystem.
  1086.     Each of these words describes a collection of files.
  1087.  
  1088.     Products are the largest collections of files.  Usually there is one
  1089.     product for each software option you can purchase.  Products have short
  1090.     names, such as "ftn" for Fortran 77.  "eoe1" and "eoe2" are the product
  1091.     names for the software that is shipped with each workstation.
  1092.  
  1093.     Products are typically divided into two (or sometimes more) images.  Most
  1094.     products have a "sw" image that contains software and a "man" image that
  1095.     contains manual pages and online release notes.  The name of an image is
  1096.     formed by concatenating its product name, a `.', and the image type.  For
  1097.     example, "eoe1.sw" and "eoe1.man" are image names.
  1098.  
  1099.     Images are subdivided into subsystems.  Each subsystem is a group of
  1100.     related files that enable particular functions.  The groupings of files
  1101.     into subsystems are chosen so that most customers will want all of the
  1102.     files in a subsystem or none of them.  Subsystem names are formed by
  1103.     taking the image name and appending a `.'  and a short name for the
  1104.     function of the subsystem.  Some examples are eoe1.sw.audio and
  1105.     eoe2.man.imagetools.
  1106.  
  1107. @  args
  1108.                                       args
  1109.  
  1110.     "args" stands for the arguments to the "view" and "date" commands.
  1111.  
  1112.     The arguments to the "date" inst commands are identical to the arguments
  1113.     of the IRIX date(1) command.  See the manual page for details.  Some
  1114.     examples of args are:
  1115.  
  1116.     date 1022160791    Set the system date to 4:07 p.m. October 22, 1991.  The
  1117.                        format is mmddhhmmyy.
  1118.  
  1119.     See "help view" for information on args to the "view" command.
  1120.  
  1121. @  date
  1122.                                       date
  1123.  
  1124.     "date" is a command on the Administrative Commands Menu.
  1125.  
  1126.     The "date" command can be used to check and set the system date.  It is
  1127.     very important during miniroot installations to have the date set
  1128.     correctly because reconfiguration of the kernel can fail if there are
  1129.     problems with the system date.
  1130.  
  1131. @  devices
  1132.                                     devices
  1133.  
  1134.     "devices" is the argument to the "mkfs" command.  It is one or more
  1135.     "special" names that are passed to the mkfs(1M) IRIX command.  See
  1136.     mkfs(1M) for the syntax of "special".  If no "devices" argument is given
  1137.     to "mkfs", the default is to make / and /usr filesystems after confirming
  1138.     with a prompt that you want to destroy everything on your / and /usr
  1139.     filesystems.
  1140.  
  1141. @  dir
  1142.                                       dir
  1143.  
  1144.     "dir" is an argument to the "mount" and "umount" commands. It is a
  1145.     directory name with the same syntax as the dir argument of the mount(1M)
  1146.     and umount(1M) commands.
  1147.  
  1148. @  fsname
  1149.                                      fsname
  1150.  
  1151.     "fsname" is an argument to the "mount" and "umount" commands.  It is a
  1152.     filesystem name with the same syntax as the fsname argument of the
  1153.     mount(1M) and umount(1M) commands.
  1154.  
  1155. @  names
  1156.                                      names
  1157.  
  1158.     "names" is an argument to the "files", "list", "install", "keep",
  1159.     "remove", and "step" commands.  It is one or more product, image, or
  1160.     subsystem names.  These names can include the shell-type wildcard.  See
  1161.     "help wildcard" for more information.
  1162.  
  1163. @  preferences
  1164.                                   preferences
  1165.  
  1166.     The "set" command takes arguments that are called preferences.  These
  1167.     preferences have values that control the behavior of inst, control the
  1168.     feedback provided by inst, and have miscellaneous other functions.  Give
  1169.     the command "set" to get a list of preferences.
  1170. @  options
  1171.                                     options
  1172.  
  1173.     See "help preferences".
  1174.  
  1175. @  source
  1176.                                      source
  1177.  
  1178.     "source" is the argument to the "from" command.  It is the name of the
  1179.     software distribution source you plan to use next.  It can be a tape drive
  1180.     on your workstation with a tape in it, a CD-ROM drive on your workstation
  1181.     with a CD in it, a distribution directory on your workstation, a CD-ROM
  1182.     drive on a remote workstation with a CD in it that has been mounted by
  1183.     cdinstmgr, or a distribution directory on a remote workstation.  See
  1184.     "help from" for the syntax of source.
  1185.  
  1186. @  all a
  1187.                                       all a
  1188.  
  1189.     "all" is a keyword argument for the "install", "keep", "list", "remove",
  1190.     and "step" commands.
  1191.  
  1192.     The "all" (or "a") keyword is a shorthand for all of the subsystems inst
  1193.     has ever seen (i.e. the list of subsystems you get with "showprods -a"
  1194.     plus anything that it is seeing for the first time in the current
  1195.     distribution) except for maint* subsystems from the past.
  1196.  
  1197. @  default d
  1198.                                     default d
  1199.  
  1200.     "default" is a keyword argument for the "install", "keep", "list",
  1201.     "remove", and "step" commands.  Default subsystems are recommended for
  1202.     installation in the absence of more refined criteria, but need not be
  1203.     installed or retained if not needed.
  1204.  
  1205.     The "default" (or just "d") keyword is a shorthand for the subsystems that
  1206.     have been chosen by the manufacturer as a basic or "starter" set of
  1207.     subsystems.  "Default" subsystems are marked with "d" after the subsystem
  1208.     name in a "list" or "step" display.
  1209.  
  1210.     *** Change from old inst ***
  1211.  
  1212.     The old inst used the symbol "*" for default subsystems.
  1213.  
  1214. @  installable A
  1215.                                   installable A
  1216.  
  1217.     "installable" is a keyword argument for the "install", "keep", "list",
  1218.     "remove", and "step" commands.
  1219.  
  1220.     The "installable" (or "A") keyword is a shorthand for all of the
  1221.     subsystems that are currently available for installation.  This is the
  1222.     default keyword for "list" and "step".
  1223.  
  1224. @  installed I
  1225.                                    installed I
  1226.  
  1227.     "installed" is a keyword argument for the "keep", "list", "remove", and
  1228.     "step" commands.  For example, "remove I" requests that all subsystems
  1229.     that are currently installed and have counterparts in the software
  1230.     distribution be selected for removal.
  1231.  
  1232.     An "I" in the third column of a subsystem listing indicates that the
  1233.     version of this subsystem in the software distribution is already
  1234.     installed.
  1235.  
  1236.     The "installed" (or "I") keyword is a shorthand for all of the subsystems
  1237.     that are installed on the target.
  1238.  
  1239.     *** Change from old inst ***
  1240.  
  1241.     The "installed" (or "I") keyword will appear only on subsystem which only
  1242.     appear on the target.
  1243.  
  1244. @  downgrade D
  1245.                                    downgrade D
  1246.  
  1247.     "downgrade" is a keyword argument for the "install", "keep", "list", and
  1248.     "step" commands.  For example, "keep D" requests that all subsystems that
  1249.     are currently installed and have downgrade counterparts in the software
  1250.     distribution be left as-is on the disk.
  1251.  
  1252.     An "D" (downgrade) single letter code in the third column of "list" or
  1253.     "step" output indicates that a newer version of this subsystem (or a
  1254.     related subsystem) is installed than is available in the software
  1255.     distribution.  In order to install the downgrade version in the software
  1256.     distribution, you must give the command "set neweroverride on".
  1257.  
  1258.     *** Change from old inst ***
  1259.  
  1260.     The old inst used the letter "N" (or "newer") for downgrade subsystems.
  1261.  
  1262. @  upgrade U
  1263.                                     upgrade U
  1264.  
  1265.     "upgrade" is a keyword argument for the "install", "keep", "list", and
  1266.     "step" commands.  For example, "install U" requests that all subsystems
  1267.     that are currently installed and have newer counterparts in the software
  1268.     distribution be installed.
  1269.  
  1270.     An "U" (upgrade) single letter code in the third column of "list" or
  1271.     "step" output indicates that a version of this subsystem (or a related
  1272.     one) is installed on the disk.  The installed version is older than the
  1273.     version in the software distribution.
  1274.  
  1275.     *** Change from old inst ***
  1276.  
  1277.     The old inst used the letter "X" (or "older") for upgrade subsystems.
  1278.  
  1279. @  upgraded u
  1280.                                    upgraded u
  1281.  
  1282.     "upgraded" is a keyword argument for the "install", "keep", "list", and
  1283.     "step" commands.  For example, "list u" shows all subsystems that are
  1284.     currently on the target that are being removed as part of an installation
  1285.     of a related (typically newer) version of the product from the
  1286.     distribution.
  1287.  
  1288.     An "u" (upgraded) single letter code in the third column of "list" or
  1289.     "step" output indicates that a this is a subsystem currently installed on
  1290.     the target, that is about to be removed because a related product on the
  1291.     distribution is marked for installation.
  1292.  
  1293. @  patches
  1294.                                     patches
  1295.     "patches" is a keyword argument for the "install", "keep", "list", and
  1296.     "step" commands.  For example, "install patches" requests all patches that
  1297.     that are in the software distribution be installed.
  1298.  
  1299. @  patchupgrade P
  1300.                                  patchupgrade P
  1301.     "patchupgrade" is a keyword argument for the "install", "keep", "list",
  1302.     and "step" commands.  For example, "install P" requests all patches that
  1303.     that are in the software distribution and that are upgrades to other
  1304.     installed patches be installed.
  1305.  
  1306.     A "P" (patchupgrade) single letter code in the third column of "list" or
  1307.     "step" output indicates that an older version of this patch is installed
  1308.     on the target.
  1309.  
  1310. @  same S s
  1311.                                      same S s
  1312.  
  1313.     "same" is a keyword argument for the "install", "keep", "list", and "step"
  1314.     commands.  For example, "keep S" requests that all subsystems that are
  1315.     currently installed and have the same version counterparts in the software
  1316.     distribution be left as-is on the disk.
  1317.  
  1318.     An "S" (same) single letter code in the third column of "list" or "step"
  1319.     output indicates that a same version of this subsystem (or a related
  1320.     subsystem) is installed.
  1321.  
  1322.     *** Change from old inst ***
  1323.  
  1324.     The old inst used the letter "I" (or "installed") for same subsystems.
  1325.  
  1326. @  new N n
  1327.                                      new N n
  1328.  
  1329.     "new" (or "N" or "n") is a keyword argument to the "install", "list",
  1330.     "step", and "keep" commands.  This keyword is a shorthand for all of the
  1331.     subsystems that do not have a version installed., or even a version once
  1332.     installed and later removed.  For example, "install N" requests that all
  1333.     subsystems that are currently not now and never have been installed on the
  1334.     target be installed.
  1335.  
  1336.     An "N" (new) single letter code in the third column of "list" or "step"
  1337.     output indicates that this subsystem is not installed.
  1338.  
  1339.     *** Change from old inst ***
  1340.  
  1341.     The old inst used the space character " " for uninstalled subsystems.
  1342.  
  1343. @  notinstalled
  1344.                                   notinstalled
  1345.  
  1346.     "notinstalled" is a keyword argument to the "install", "list", "step", and
  1347.     "keep" commands.  This keyword is a shorthand for all of the subsystems
  1348.     that do not have a version currently installed.  For example,
  1349.     "install notinstalled" requests that all subsystems that are not installed
  1350.     on the target be installed.
  1351. @  removable L
  1352.                                    removable L
  1353.  
  1354.     "removable" is a keyword argument for the "keep", "list", "remove", and
  1355.     "step" commands.
  1356.  
  1357.     The "removable" (or "L") keyword is a shorthand for all of the subsystems
  1358.     that are currently installed and can be removed from the system.  There
  1359.     are three types of subsystems that might be installed on the system, but
  1360.     are not removable:  maintenance subsystems (i.e. maint*.*.*), subsystems
  1361.     required for proper operation of IRIS (i.e. eoe1.sw.unix), and subsystems
  1362.     that must be installed from the miniroot.  This third case, subsystems
  1363.     that must be installed from the miniroot, applies only when inst is
  1364.     invoked from IRIX rather than the miniroot.
  1365.  
  1366. @  uninstalled
  1367.                                   uninstalled
  1368.  
  1369.     "uninstalled" is a keyword argument for the "install", "keep", "list",
  1370.     "remove", and "step" commands.
  1371.  
  1372.     The "uninstalled" keyword is a shorthand for subsystems that meet all of
  1373.     these conditions:  they were available for installation in the past, they
  1374.     are not presently installed, they don't have a version available in the
  1375.     distribution, and they are not maint* subsystems.
  1376.  
  1377. @  ?
  1378.                                        ?
  1379.  
  1380.     "?" is a pseudo-command.  Use it to redisplay the current menu.  Pressing
  1381.     just the <Enter> key also redisplays the current menu.
  1382.  
  1383. @  inst
  1384.                                       inst
  1385.  
  1386.     "inst" is the name of the installation program you are using.  It is fully
  1387.     documented in the inst(1M) manual page and the IRIS Software Installation
  1388.     Guide.  The "help" topic "overview" describes the inst installation
  1389.     process.
  1390.  
  1391. @  more
  1392.                                       more
  1393.  
  1394.     "more?" is a prompt that appears when the output of such commands as
  1395.     "list", "files", "help" or "set" is longer than one screenful.  The output
  1396.     stops after each screenful and the prompt
  1397.  
  1398.         more? (h=help)
  1399.  
  1400.     appears.  At this point, you press a key that depends on what you want to
  1401.     do:
  1402.  
  1403.     Desired Action:                      Press:
  1404.  
  1405.     display next screenful               y or space bar
  1406.  
  1407.     display next line                    <Enter>
  1408.  
  1409.     quit this command (no more output)   n or q
  1410.  
  1411. @  beginner
  1412.                                     beginner
  1413.  
  1414.     See "help overview".
  1415.  
  1416. @  overview
  1417.                                     overview
  1418.  
  1419.     inst is the Silicon Graphics software installation tool.  If you're a
  1420.     first-time or infrequent user, please take a few minutes to read this and
  1421.     learn a few key points about how inst works.
  1422.  
  1423.     With inst, you install collections of files called subsystems rather than
  1424.     individual files.  Subsystem names have three parts separated by periods,
  1425.     for example "eoe1.sw.unix".  The first part is the product name, the
  1426.     second part is the image name and the third part is the subsystem.
  1427.  
  1428.     A typical user's session with inst will help you get an idea of how to use
  1429.     inst:
  1430.  
  1431.     1.  When inst first comes up, the user checks the first line, "Default
  1432.         location of of software is <location>", to make sure <location> is the
  1433.         software distribution source she wants.  If not, she uses the "from"
  1434.         command to specify a different software distribution source.
  1435.  
  1436.     2.  Next, the user gives the "list" command to list the software
  1437.         (subsystems) that is available for installation.  The subsystems that
  1438.         inst has selected for installation are marked with `i' in the first
  1439.         column.
  1440.  
  1441.     3.  If the user disagrees with inst about what should be installed and/or
  1442.         wants to remove software that is no longer needed, she uses the
  1443.         "install", "remove", "keep" and/or "step" commands until she is
  1444.         satisfied with the installation and removal selections that the "list"
  1445.         command displays.
  1446.  
  1447.     4.  The user gives the "go" command to initiate the actual installation
  1448.         and removal of subsystems.
  1449.  
  1450.     5.  The user gives the "quit" command to leave inst.
  1451.  
  1452.     The remainder of this "help" topic explains these steps in more detail.
  1453.  
  1454.     When you first bring up inst, it makes guesses about the location of the
  1455.     software you want to install and what software you want to install.  The
  1456.     message "Default location of software is ..." tells you this location.
  1457.     (Hint:  you can see this location at any time by giving the "set" command
  1458.     and looking at the value of "dist".)
  1459.  
  1460.     If the location that inst has chosen is not correct, the "from" command
  1461.     allows you to change it.  Read "help from" to find out how to use the from
  1462.     command.  (Hint:  if you want to install just one product and you are
  1463.     installing from CD-ROM or a distribution directory on a remote machine, it
  1464.     is easiest to use a "from" command of the form
  1465.     "from server:/distdir/product".)
  1466.  
  1467.     To see what software inst has guessed that you want to install, give the
  1468.     command "list".  If the product descriptions (information about each of
  1469.     the products in the software distribution) have not been read by inst,
  1470.     they are read now.  A disk space calculation is done next.  (Reading
  1471.     product descriptions and doing disk space calculations takes a few minutes
  1472.     so they are done only when required.  They are not done every time you
  1473.     give the "list" command.)  Finally, the list of subsystems appears.
  1474.  
  1475.     Some of the subsystems have an i in the first column which means that they
  1476.     are selected for installation.  (Hint:  if you would rather start with a
  1477.     blank slate (i.e. no subsystems selected for installation), give the
  1478.     command "keep *".)  Later, you should read "help list" to get more details
  1479.     about the list display.  You can also ask for "help" on any of the single
  1480.     characters you see surrounding the subsystem names in the third column.
  1481.  
  1482.     If you would like to modify the selections that inst has made, there are
  1483.     several ways to do this.  One way to change the selections is the use the
  1484.     "install", "remove", and "keep" commands.  A different way to make your
  1485.     selections is to use the interactive "step" command.  These commands are
  1486.     cumulative, so you can give them as many times as you need to to make all
  1487.     of your selections.  No software is installed or removed until you give
  1488.     the "go" command.
  1489.  
  1490.     Here are some examples of the "install", "remove", "keep" and "step"
  1491.     commands:
  1492.  
  1493.     install eoe2.sw.imagetools   Select eoe2.sw.imagetools for installation
  1494.                        (mark subsystems with `i' in "list"/"step" output)
  1495.  
  1496.     remove eoe*.man    Select eoe1 and eoe2 manual page subsystems for removal
  1497.                        (mark subsystems with `r' in "list"/"step" output)
  1498.  
  1499.     install U          Update currently installed subsystems (adds `i' to all
  1500.                        subsystems already marked `U' in "list"/"step" output)
  1501.  
  1502.     step eoe2          Use interactive mode for the subsystems in eoe2:  each
  1503.                        subsystem is displayed one at a time and you type one
  1504.                        key to select installation, removal, keep, or retain
  1505.                        current status.  See "help step".
  1506.  
  1507.     keep *             Cancel all installation and removal requests (mark
  1508.                        subsystems with `k' or ` ' in "list"/"step" output)
  1509.  
  1510.     The way to understand the "keep" command is to think "keep things the way
  1511.     they are".  It basically means "don't install a new version" or "don't
  1512.     remove the current version" or "don't do anything at all" depending on the
  1513.     circumstances.  `*' can be used as a wildcard in names, just as it is used
  1514.     as a wildcard for file names when you're in the IRIX shell (see
  1515.     "help wildcard").  Certain special characters and words, such as `U' in
  1516.     the example above are called `keywords' and stand for groups of subsystems
  1517.     that share a particular characteristic.  See "help keywords" to find out
  1518.     about keywords.
  1519.  
  1520.     To see what your current selections are at any time, give the "list"
  1521.     command without arguments.  See "help selection" for more information
  1522.     about making selections.  When you are satisfied with the selections that
  1523.     "list" shows, give the "go" command to tell inst to perform the
  1524.     installation and removal of the subsystems you have selected.  All of the
  1525.     pending installation and removal requests (selections) are performed.
  1526.     inst automatically removes older revisions of the new software you
  1527.     install, so you do not need to explicitly remove old software first.
  1528.  
  1529.     When you are done installing and removing software, use the "quit" command
  1530.     to exit the installation program.  If you have installed software from the
  1531.     miniroot, you are asked if you want to restart the system and you should
  1532.     answer "yes".
  1533.  
  1534.     Additional help is available on many topics.  The command "help" without
  1535.     any arguments lists the topics.  The IRIS Software Installation Guide is
  1536.     the reference manual for inst and contains troubleshooting information
  1537.     which can be useful if you encounter errors.  Information about the
  1538.     specific products you are installing, any compatibility issues with those
  1539.     products and prerequisites for those products is available from the
  1540.     Release Notes for the different products.
  1541.  
  1542. @  miniroot b
  1543.                                    miniroot b
  1544.  
  1545.     This "help" topic describes the miniroot, a special installation
  1546.     environment.
  1547.  
  1548.     The installation program inst can be run as an IRIX command from the
  1549.     shell, or it can be run from the miniroot.  The miniroot is a small set of
  1550.     programs (the IRIX kernel, a few commands, and inst) that is copied into
  1551.     the swap partition of a disk after you shut down your workstation and give
  1552.     some special commands to the PROM Monitor.  These commands copy the
  1553.     miniroot from tape, CD-ROM, or a remote distribution directory to your
  1554.     swap partition, then boot the miniroot kernel and start the execution of
  1555.     inst.  This procedure is called loading the miniroot and is described
  1556.     fully in the IRIS Software Installation Guide.
  1557.  
  1558.     Booting the miniroot kernel, rather than the kernel in /unix, gives inst
  1559.     the ability to install new versions of all files without the
  1560.     inconsistencies that could result from replacing programs while they are
  1561.     running.
  1562.  
  1563.     Some subsystems must be installed from the miniroot rather than from IRIX.
  1564.     Situations where proper installation requires reconfiguring the kernel or
  1565.     where having files temporarily removed would cause system failure are
  1566.     examples of situations that require miniroot installation.
  1567.  
  1568.     Some commands on the Administrative Functions Menu can only be performed
  1569.     while in the miniroot.  These are "mkfs", "mount" with arguments and
  1570.     "umount".
  1571.  
  1572.     If a subsystem is marked "miniroot", it contains files that must be
  1573.     installed using the miniroot inst. Miniroot subsystems have a "b"
  1574.     following their name in "list" and "step" output.
  1575.  
  1576. @  required q
  1577.                                    required q
  1578.  
  1579.     "required" is a characteristic of some subsystems and a keyword argument
  1580.     for the "install", "keep", "list", "remove", and "step" commands.
  1581.  
  1582.     If a subsystem is "required", it contains programs and files that are
  1583.     required for proper operation of the workstation.  The IRIX kernel is
  1584.     included in a "required" subsystem for instance.  Required subsystems have
  1585.     a `r' following their name in "list" and "step" output.
  1586.  
  1587.     The keyword "required" (or just "q") can be used with the "install",
  1588.     "remove", "keep", "list" and "step" commands as a shorthand for the list
  1589.     of subsystems that is required.
  1590.  
  1591. @  prerequisite
  1592.                                   prerequisite
  1593.  
  1594.     This "help" topic discusses missing prerequisites errors.
  1595.  
  1596.     Some subsystems require other subsystems also be installed in order to
  1597.     work correctly.  These requirements are known by inst, and it does not let
  1598.     you install a subsystem that has this type of requirement unless the
  1599.     subsystem it depends on is already installed or is also selected for
  1600.     installation.  To correct this error condition, install the prerequisite
  1601.     subsystem, or deselect the subsystem that has the dependency.  This error
  1602.     can be overridden using the "rulesoverride" option.  Use this option with
  1603.     extreme care since not installing prerequisite software can lead to
  1604.     erroneous system behavior. See "help conflicts" for more on resolving
  1605.     prerequisite conflicts.
  1606.  
  1607. @  nfs
  1608.                                       nfs
  1609.  
  1610.     inst will allow installation of software into directories that have been
  1611.     NFS-mounted, as long as you have permission to write into those
  1612.     directories from the local machine.
  1613.  
  1614.     Since software installations normally take place on the local host, inst
  1615.     asks the user to confirm installations into NFS-mounted directories.
  1616.  
  1617.     By setting the "confirm_nfs_installs" resource to false, inst will quietly
  1618.     install into NFS-mounted directories as long as the user has the
  1619.     appropriate write-permissions.
  1620.  
  1621. @  readerror
  1622.                                    readerror
  1623.  
  1624.     This "help" topic provides information about the possible causes when the
  1625.     inst program can't read a software distribution.
  1626.  
  1627.     Read errors can occur in a variety of instances.  inst is unable to
  1628.     distinguish between the different problems, but in some cases error
  1629.     messages from programs called by inst appear before inst's read error
  1630.     message and help you determine the source of the problem.  Possible
  1631.     problems are:
  1632.  
  1633.     o   The copy of the software distribution is bad.
  1634.  
  1635.     o   Your version of inst cannot read the software distribution because
  1636.         they are incompatible.  The solution is to install a newer version of
  1637.         system software (eoe1.sw.unix specifically).
  1638.  
  1639.     o   If you are installing from a tape drive, inst may be having trouble
  1640.         positioning or reading the tape, or it may not be accessing the
  1641.         correct tape drive.
  1642.  
  1643.     o   There are I/O problems with the local or remote disk or CD-ROM drive
  1644.         you are installing software from.
  1645.  
  1646.     o   There are network problems such as a timeout error or a tftp error.
  1647.         See "help networkerror".
  1648.  
  1649.     o   The account you are using on the remote workstation is protected by a
  1650.         password.
  1651.  
  1652.     o   The remote workstation went down.
  1653.  
  1654.     o   You have given the wrong pathname for a distribution directory or it
  1655.         does not contain a complete set of software distribution files.
  1656.  
  1657.     More information on diagnosing read error problems is available in the
  1658.     IRIS Software Installation Guide.
  1659.  
  1660. @  timeouterror
  1661.                                   timeouterror
  1662.  
  1663.     This "help" topic provides information on network timeout errors.
  1664.  
  1665.     Network timeout errors occur when inst has established a connection with a
  1666.     remote workstation, but during one of its read operations, it was unable
  1667.     to get any blocks for a period of time.
  1668.  
  1669.     When you get this error, use the "stop" command on the Interrupt/Error
  1670.     Menu to get back to the Inst Main Menu.  Next, use the command "set" and
  1671.     look at the value of "timeout" to find out the current period of time that
  1672.     inst is waiting for network input.  You can change that period with the
  1673.     command "set timeout <n>" where <n> is the new timeout period in seconds
  1674.     (typically in the range of 60 to 300).  After changing the network timeout
  1675.     period, you can proceed with installation, probably by giving the "go"
  1676.     command.
  1677.  
  1678. @  lverror
  1679.                                     lverror
  1680.  
  1681.     This "help" topic provides information on logical volume errors.
  1682.  
  1683.     If you have an /etc/lvtab file, inst invokes lvinit to initialize the
  1684.     drivers corresponding to the logical volumes specified in /etc/lvtab.  If
  1685.     lvinit fails, you get an error message from lvinit, while filesystems are
  1686.     being mounted, before inst is invoked.
  1687.  
  1688.     You can continue installation without doing anything, but the logical
  1689.     volume given in the lvinit error message is not accessible.  If you want
  1690.     to fix the problem before continuing with installation, you can escape to
  1691.     a shell with the "sh" command and repair the problem while in the shell.
  1692.     The lvinit error message describes the problem and the lvck(1M) manual
  1693.     page lists the possible causes of logical volume problems.
  1694.  
  1695. @  kernelerror
  1696.                                   kernelerror
  1697.  
  1698.     This "help" topic provides information about problems encountered while
  1699.     configuring the UNIX kernel.
  1700.  
  1701.     After you give the "quit" command, inst performs several operations to
  1702.     complete the software installation process.  One of these operations uses
  1703.     autoconfig(1M) to configure a UNIX kernel (i.e. create the file /unix from
  1704.     several files contained in the software distribution) and put it into a
  1705.     file called unix (it is /root/unix while you are in the miniroot).
  1706.  
  1707.     If you get an ERROR IN KERNEL CONFIGURATION message, inst has detected a
  1708.     problem during autoconfig's kernel configuration process.  Possible causes
  1709.     and their solutions are:
  1710.  
  1711.     o   Tools required by autoconfig or key kernel components are missing.
  1712.  
  1713.         The tools required by autoconfig and key kernel components are in the
  1714.         subsystem called eoe1.sw.unix.  Re-install this subsystem if there is
  1715.         a possibility that it is not installed properly or that some files in
  1716.         it have been deleted since its installation.
  1717.  
  1718.     o   The kernel components present on your system are incompatible.
  1719.  
  1720.         Kernel components from different releases may not be compatible.  To
  1721.         check for incompatible components, give the "sh" command to escape to
  1722.         a shell and then give the command "ls -lt /root/var/sysgen/boot/*.o".
  1723.         By examining the dates, you may be able to identify old .o files that
  1724.         were part of a release that is incompatible with the new software you
  1725.         just installed.  Use "rm" to remove these old .o files.  Return to
  1726.         inst by giving the "exit" command.
  1727.  
  1728.     You can run the autoconfig program manually at any time to see what error
  1729.     messages it gives you or to verify that you have corrected the problem
  1730.     that caused it to fail.  To run autoconfig, give the "sh" command to
  1731.     escape to a shell and then give the command
  1732.  
  1733.         chroot /root /etc/autoconfig
  1734.  
  1735.     If this autoconfig is successful, move the new unix in place by doing:
  1736.  
  1737.         mv /root/unix.install /root/unix
  1738.  
  1739.     Once you have corrected the problem that caused autoconfig to fail, you
  1740.     should be able to give the "quit" command and terminate normally.
  1741.  
  1742. @  return
  1743.                                      return
  1744.  
  1745.     "return" is a command on the View and Administrative Commands Menus.  It
  1746.     changes your current menu to the Inst Main Menu.
  1747.  
  1748.     If you want to execute a command from the Inst Main Menu while you are in
  1749.     the Administrative Commands Menu, you can give the command
  1750.     "return <command>".  It executes <command> as if your current menu were
  1751.     the Inst Main Menu, but leaves you in the Administrative Commands Menu.
  1752.  
  1753. @  check
  1754.                                      check
  1755.  
  1756.     This "help" topic explains the pre-installation checks that are performed
  1757.     after you give the "go" command, but before actual installations and
  1758.     removals are performed.  inst checks to see that:
  1759.  
  1760.     1.  All "required" subsystems will be installed after your requests are
  1761.         completed.  Use "help required" for more information.
  1762.  
  1763.     2.  You are using miniroot installation if you have requested that any
  1764.         subsystems that require miniroot installation be installed.  Use
  1765.         "help miniroot" for more information.
  1766.  
  1767.     3.  The versions of the subsystems you have requested to be installed are
  1768.         newer that the versions that are presently installed, if any.  This
  1769.         check is not performed if you have given the command
  1770.         "set neweroverride on".
  1771.  
  1772.     4.  All prerequisites will be satisfied after installation and/or removal
  1773.         is complete.  Use "help prerequisite" for more information.
  1774.  
  1775.     5.  There is enough disk space to install all of your requests.  Use
  1776.         "help spaceerror" for more information.
  1777.  
  1778.     6.  All of the subsystems you have selected for installation are
  1779.         compatible with each other and the subsystems you already have
  1780.         installed.  Use "help incompatible" for more information.
  1781.  
  1782. @  base
  1783.                                       base
  1784.  
  1785.     This "help" topic gives the definition of the phrase "base release".
  1786.  
  1787.     A base release is a software release that contains all of the files for a
  1788.     particular software product at a certain release level.  These files are
  1789.     grouped into subsystems with names of the form
  1790.     <product>.<image>.<subsystem>.  You see these names when you give the
  1791.     "list" and "step" commands.  All of the subsystems that have the same
  1792.     <product> name comprise the base release of a product.  (There is an
  1793.     exception to this: <product> names that begin with "maint" are not
  1794.     considered base releases.)
  1795.  
  1796. @  view
  1797.                                       view
  1798.  
  1799.     "view" is a command on the Inst Main Menu and a short name for the View
  1800.     Commands Menu.
  1801.  
  1802.     Give the "view" command when you want to switch to the View Commands Menu.
  1803.  
  1804.     Alternatively, if you want to execute a command from the View Commands
  1805.     Menu while you are in the Inst Main Menu, you can give the command
  1806.     "view <command>".  It executes <command> as if your current menu were the
  1807.     View Commands Menu, but leaves you in the Inst Main Menu.
  1808.  
  1809.     The View Commands Menu provides a variety of functions to control which
  1810.     software products are visible when using the "list" and "step" commands.
  1811.     See "help <command>" for each of the commands on the View Commands Menu to
  1812.     learn more about them.
  1813.  
  1814.     The following commands are available from the View Commands Menu, but are
  1815.     not listed: "quit" and "help".
  1816. @  dist
  1817.                                       dist
  1818.  
  1819.     "dist" is a command on the View Commands Menu.
  1820.  
  1821.     The "dist" command causes the "list" and "step" commands to show software
  1822.     product versions on the distribution, hiding product versions that are (or
  1823.     were) installed on the target.
  1824.  
  1825.     See "help distribution" and "help target" for a discussion of what a
  1826.     distribution and target are.
  1827. @  targ
  1828.                                       targ
  1829.  
  1830.     "targ" is a command on the View Commands Menu.
  1831.  
  1832.     The "targ" command causes the "list" and "step" commands to show software
  1833.     product versions that are (or were) installed on the target, hiding
  1834.     product versions on the distribution.
  1835.  
  1836.     Invoking the "targ" command turns off the affects of the "dist" command,
  1837.     and vice versa.
  1838.  
  1839.     *** Change from old inst ***
  1840.  
  1841.     In earlier versions of inst, the Main Menu Command "versions" was used to
  1842.     administer products installed on the target.  This "versions" command is
  1843.     no longer available from within inst.
  1844.  
  1845.     Instead, use the "view targ" command to switch to target view, and then
  1846.     use the "list" and "step" commands to manage installed software products.
  1847.  
  1848.     The "install", "remove" and "keep" commands can be used on any product in
  1849.     either view ("targ" or "dist").
  1850.  
  1851. @  level
  1852.                                      level
  1853.  
  1854.     "level" is a command on the View Commands Menu.
  1855.  
  1856.     The "level" command with no arguments displays the current view level: (1)
  1857.     product, (2) image or (3) subsystem.
  1858.  
  1859.     To change the view level, use the "level" command with one argument,
  1860.     either a number 1, 2 or 3 or the corresponding word product, image or
  1861.     subsystem.
  1862.  
  1863.     When at view level 1, only top level products, such as "eoe1", are
  1864.     displayed by "list" and "step" commands.
  1865.  
  1866.     What at view level 2, only second level images, such as "eoe1.sw", are
  1867.     displayed by "list" and "step" commands.
  1868.  
  1869.     When at view level 3 (the default), only third level subsystems, such as
  1870.     "eoe1.sw.unix", are displayed by "list" and "step" commands.
  1871.  
  1872. @  sort
  1873.                                       sort
  1874.  
  1875.     "sort" is a command on the View Commands Menu.
  1876.  
  1877.     The "sort" command controls the order of lines output by the "list" and
  1878.     "step" commands.
  1879.  
  1880.     After issuing "sort name" (the default), lines are sorted in alphabetical
  1881.     order on the product name.
  1882.  
  1883.     After issuing "sort size", lines are sorted in increasing numeric order on
  1884.     the products absolute size.  Since the default size value displayed (the
  1885.     default value of the preference show_absolute_sizes) is to show net change
  1886.     sizes, not absolute, this sort order will appear unsorted unless you set
  1887.     the preference show_absolute_sizes to the value true.
  1888.  
  1889. @  show
  1890.                                       show
  1891.  
  1892.     "show" is a command on the View Commands Menu.
  1893.  
  1894.     The "show" command displays the current values of the settings available
  1895.     on the View Commands Menu.
  1896.  
  1897. @  maintenance
  1898.                                   maintenance
  1899.  
  1900.     This "help" topic gives the definition of the phrase "maintenance
  1901.     release".
  1902.  
  1903.     There are two types of software releases, "base" and "maintenance".
  1904.     Maintenance releases contain just a few files from one or more software
  1905.     products. (Base releases contain all files of a single software product,
  1906.     see "help base".)  Files are typically included in the maintenance release
  1907.     because they contain bug fixes or support for hardware that was released
  1908.     after the last base release of the software.
  1909.  
  1910.     The subsystems of maintenance releases are always named
  1911.     maint<xxx>.<yyy>.<subsystem>.  <xxx> is usually a digit or a <product>
  1912.     name and <yyy> is created from the <product> and <image> names of base
  1913.     release.
  1914.  
  1915. @  distribution
  1916.                                   distribution
  1917.  
  1918.     A collection of installable software in a given location.  Also, the media
  1919.     containing the installable software, such as a compact disk or a
  1920.     designated disk directory.
  1921.  
  1922.     If the distribution is set to "none", inst will not load one
  1923.     automatically.  This can save time if you are just removing or browsing
  1924.     installed software.
  1925.  
  1926. @  target
  1927.                                      target
  1928.  
  1929.     The workstation or server that is designated to receive software during an
  1930.     installation.
  1931.  
  1932. @  help
  1933.                                       help
  1934.  
  1935.     "help" is a command on the Inst Main Menu.  It is also available from the
  1936.     Administrative Commands Menu.
  1937.  
  1938.     Help on software installation is available from the IRIS Software
  1939.     Installation Guide, from the Release Notes for the software products you
  1940.     want to install, and from the inst program's extensive online help.  To
  1941.     get online help, use the command
  1942.  
  1943.         help <topic>
  1944.  
  1945.     where <topic> is a word of your choice.  Almost any word you see on a
  1946.     menu, single letters you see in the output of "list" and "step", and many
  1947.     inst "jargon" words have help.  If you are unfamiliar with the inst
  1948.     program or totally confused, start with "help overview".  If "help" output
  1949.     is more than one screen full, a "more? (h=help)" prompt appears after one
  1950.     screen full.  Press the <Space Bar> key to see the next screenful.
  1951.  
  1952.     The complete list of "help" <topic>s is:
  1953.  
  1954.  
  1955.     *                 dist              mkfs              s
  1956.     .N                distribution      more              same
  1957.     .O                downgrade         mount             save
  1958.     ?                 files             n                 selection
  1959.     A                 filter            names             set
  1960.     D                 from              networkerror      sethostipaddr
  1961.     I                 fsname            new               sethostname
  1962.     L                 go                nfs               sh
  1963.     N                 hardware          notinstalled      show
  1964.     P                 help              options           shroot
  1965.     R                 i                 overview          sort
  1966.     S                 image             patches           source
  1967.     U                 incompatible      patchupgrade      space
  1968.     a                 inst              preferences       spaceerror
  1969.     admin             install           prerequisite      step
  1970.     all               installable       product           subsystem
  1971.     args              installed         q                 targ
  1972.     b                 k                 quit              target
  1973.     base              keep              r                 timeouterror
  1974.     beginner          kernelerror       readerror         u
  1975.     check             keywords          recalculate       umount
  1976.     config            level             removable         uninstalled
  1977.     conflicts         list              remove            unmount
  1978.     d                 load              removed           upgrade
  1979.     date              lverror           request           upgraded
  1980.     default           main              required          view
  1981.     devices           maintenance       return            wildcard
  1982.     dir               miniroot
  1983.